home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 726-750 / 742 / icalc / readme.first < prev    next >
Text File  |  1995-03-18  |  5KB  |  137 lines
  1.  
  2. icalc version 2.1
  3. (C) 1991, 1992 Martin W. Scott. All Rights Reserved.
  4.  
  5. Welcome to icalc version 2.1! If you're new to icalc, first read this
  6. document, then the 'UserGuide'. If you've used version 2.0 before, a
  7. glance at the 'History' and a quick review of the 'Advanced Guide' will
  8. bring you up to date.  Users of the versions 1.x should re-read all
  9. docmentation.
  10.  
  11. Version 2.0 contained a major bug fix to the sqrt function, some minor
  12. (pvr-based) bug fixes to the inverse trig functions, and many major
  13. enhancements since version 1.1.
  14.  
  15. Version 2.1 contains a yet another bug-fix of the sqrt function,
  16. plus a couple of other minor fixes. In version 2.0, sqrt would very
  17. rarely behave incorrectly, due to an obscure rounding error. This has
  18. been fixed, hopefully for the last time.
  19.  
  20. This version introduces flexible number-base control (so you can do all
  21. your calculations in hexadecimal if you want) plus one or two minor
  22. enhancements. Also included are some powerful scripts to perform
  23. numerical integration and polynomial root-finding.
  24.  
  25.  
  26. Overview
  27. --------
  28. icalc is a (shell-based) calculator/programming language, with a number
  29. of powerful features. Programmers will find the base conversion useful,
  30. complex arithmetic will aid those working in electronics, and a host of
  31. other capabilities should satisfy most people's needs:
  32.  
  33.     - evaluates complicated expressions in same manner as many
  34.       programing languages and advanced pocket calculators;
  35.  
  36.     - many built-in functions and constants;
  37.  
  38.     - arbitrarily named variables;
  39.  
  40.     - user-defined functions with C-like control-structures;
  41.  
  42.     - one-dimensional arrays;
  43.  
  44.     - performs complex-number arithmetic (including trig stuff etc.);
  45.  
  46.     - can work in any number-base from 2 to 36;
  47.  
  48.     - extensible through script files;
  49.  
  50.     - much more...
  51.  
  52.  
  53. You can react in a number of ways to the above list:
  54.  
  55.     Reaction:  Looks too complicated for me!
  56.     My Answer: You don't have to utilise what you don't want/need to;
  57.            you can use icalc at a number of different levels.
  58.  
  59.     Reaction:  It's free, so it's bound to be pretty crap...
  60.     My Answer: Try it out. If you still think that, pass it over. I
  61.            could have made it shareware, but it's against my
  62.            principles (still an idealist at my age...)
  63.  
  64.     Reaction:  Who needs another programming language?
  65.     My Answer: icalc is fast enough for many math tasks, and is quick
  66.            to get into -- no compilation etc., it's interactive,
  67.            and great for prototyping. Plus, if you need complex
  68.            arithmetic, you don't have to write loads of support
  69.            routines, I've already done that.
  70.  
  71.  
  72. Documentation
  73. -------------
  74. Apart from this file and the history, instructions are split into two
  75. parts, a User Guide, and an Advanced Guide. The user guide covers
  76. material explaining the calculator nature of icalc, with simple function
  77. definition; the Advanced Guide covers control-structures, arrays and
  78. more complicated function definitions.
  79.  
  80. You may notice that the User Guide is nicely formatted, whilst the
  81. Advanced Guide is not. This is because I used nro for document processing
  82. in the past, but intend switching it over to TeX (sometime).
  83.  
  84.  
  85. Installation
  86. ------------
  87. icalc uses the standard Commodore mathieeedoub-libraries, which should
  88. be in your LIBS: directory. You may optionally copy the 'icalc.init'
  89. file to your S: directory. It contains various useful extensions to
  90. icalc, and is read on startup. (There is an extensively commented
  91. version for your perusal too.)
  92. That's it.
  93.  
  94.  
  95. Scripts
  96. -------
  97. icalc comes with a few useful scripts. If you write any that you think
  98. may be useful, send them to me and I'll include them in the next release.
  99.  
  100.  
  101. Contact + Moans
  102. ---------------
  103. Source is available on request, for a fee of $25 (US), or equivalent in
  104. your currency. Cash or IMOs/Eurochecques are preferable to Bank cheques.
  105. For the same fee, versions compiled for 680x0 with 6888x can be obtained.
  106. (One fee covers both, though).
  107.  
  108. Of course, if you like icalc and are a kind-hearted soul, I'll gladly
  109. accept any money you may wish to send (poor student and all that).
  110.  
  111. Send all comments, suggestions, bug-reports, scripts, money etc. to me at:
  112.  
  113.     Martin W. Scott,
  114.     23, Drum Brae North,
  115.     Edinburgh  EH4 8AT,
  116.     United Kingdom.
  117.  
  118. I can be contacted by email (until about June 1993) at:
  119.  
  120.     mws@castle.ed.ac.uk
  121.  
  122. I would like to thank the (few) people who have responded to previous
  123. versions of icalc. Although I write software mainly for myself, I go to
  124. considerable effort making it releasable (such as writing documentation,
  125. retaining compatability with previous versions).
  126.  
  127. If I get little or no response from this release, I must assume that
  128. little or no people are using it, and thus will stop issuing updates and
  129. bug fixes. icalc is NOT shareware, and although I'm happy to receive
  130. contributions for my efforts, I don't expect them. I DO expect people to
  131. let me know they're using icalc though, even if it's just a postcard.
  132.  
  133.  
  134. Thank you for reading, and enjoy...
  135.  
  136.     Martin.
  137.